home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / c / sozobon / sozbin15.zoo / sozdistr / doc / binary.doc / jas.man < prev    next >
Encoding:
Text File  |  1995-09-03  |  3.8 KB  |  128 lines
  1. JAS (1)                 USER COMMANDS                           JAS(1)
  2.  
  3. NAME
  4.  
  5.         jas  -  Joe's assembler - the SOZOBON(X) assembler
  6.  
  7.  
  8. SYNOPSIS
  9.  
  10.         jas [options] [-o <object file>] <source file>
  11.  
  12.         jas [options] <inputfile> [<outputfile>[ <errorfile>]]
  13.  
  14.         jas [-VvhN8lu] [-L<n>] [-s <dir>] <source file>
  15.                    [[-o ]<object file>] [[-E]<errorfile>]
  16.  
  17.  
  18. DESCRIPTION            
  19.  
  20.       The  jas  assembler is designed for compatibility with the Alcyon
  21.       assembler.   It   doesn't  provide  many  features  the  assembly
  22.       language  programmer  might want, but is intended more for use by
  23.       a  compiler  front-end.  Jas generally produces smaller code than
  24.       the  Alcyon  assembler  because  it  is  smarter about generating
  25.       short  branch  instructions.   Also,  jas uses no temporary files
  26.       and runs quite a bit faster than Alcyon.  
  27.  
  28.       Jas works as a filter on the input file (68000 assembler sorce code);
  29.       if no output file is given, the generated object is written to a file
  30.       with same name but suffix '.o'. You can use '-' for input file and
  31.       output file, too. Jas will read then from stdin, and/or write to
  32.       stdout.
  33.  
  34.       Pseudo opcodes:
  35.  
  36.       structure
  37.         .text
  38.         .bss
  39.         .data
  40.         .end
  41.  
  42.       symbols
  43.         .comm <symbol>,<size>  (common symbol with size <size> in Bytes
  44.                                   or 0 for extern definition; variable)
  45.         .globl <symbol>        (global symbol; text or variable)
  46.  
  47.         <symbol>:              (this is symbol <symbol>; definition)
  48.  
  49.         Undefined but used symbols are extern globals, defined symbols
  50.         are local by default. 
  51.  
  52.       define data
  53.         .dc.S <value> [<value>, ...]    e.g.: .dc.l 0, 0
  54.                                               .dc.b "this is a string",0
  55.         .ds.S <count>                   e.g.: .ds.w 2
  56.  
  57.         
  58.       others:
  59.         .even   align following statements to even address
  60.         .equ <macro> <text>
  61.         .org <address>
  62.  
  63. OPTIONS
  64.  
  65.       Some  of  the command line options are accepted for compatibility
  66.       with  the  Alcyon  assembler,  but  are  actually  ignored.   The
  67.       following command line options are supported: 
  68.  
  69.  
  70.         --version
  71.         -V      (Version)
  72.            Print a version message and exit.  
  73.  
  74.         -v      (verbose)
  75.            Print a short version info, the size of the generated object
  76.            module and some information about optimizing branches and jumps.
  77.            
  78.         -h      (help)
  79.            Print the usage message and exit.
  80.  
  81.         -N
  82.            Don't optimize (esp. don't generate 'short' branch 
  83.            instructions).  
  84.  
  85.         -8      (short names)
  86.            Don't generate SozobonX symbols for names longer than 8
  87.            characters, but cut them to a length of 8.
  88.  
  89.         -L<n>   (Local symbols) 
  90.            By  default,  no local symbols are placed in the symbol
  91.            table  of  the output. This option instructs jas to put
  92.            all  symbols  into  the  symbol  table  if  n  is  2 or
  93.            greater.  If  the  option '-L1' is given, symbols whose
  94.            name  doesn't  start with 'L' ot 'T' are written to the
  95.            symbol table.  
  96.  
  97.         -o <file> 
  98.  
  99.            By default, the assembler replaces the input file's extension
  100.            ('.s') with '.o' to form the name of the output.  This option
  101.            can be used to write the output to any file. 
  102.  
  103.         ignored for compatibility:
  104.  
  105.         -l 
  106.  
  107.         -u 
  108.  
  109.         -s <dir> 
  110.  
  111.  
  112.  
  113. ENVIRONMENT
  114.  
  115.         If $STDERR is present, stderr handle (2) is used for diagnostic
  116.         output; if not and no ARGV was used it will be CONsole handle (-1).
  117.  
  118.  
  119. BUGREPORTS
  120.  
  121.         Current maintainer is Thorsten Roskowetz. Please send bugreports
  122.         using the 'bugform' to
  123.         rtroskow@jupiter.rz.Uni-Osnabrueck.DE (Thorsten Roskowetz)
  124.  
  125.  
  126. SEE ALSO
  127.         cc(1), make(1), nm(1)
  128.